home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / CDS242.ARJ / CDS.DOC next >
Text File  |  1992-08-16  |  11KB  |  281 lines
  1.  
  2. CDS Version 2.42
  3. Copyright Nathan Hartwell, PSI Software 1992.  All rights reserved.
  4.  
  5.                               WARNING!            
  6.                     -----------------------------
  7. There are rare circumstances in which versions of CDS prior to 2.30 
  8. can result in loss of data.  Please use 2.30 or later.
  9.  
  10.                                 *NOTE*             
  11.                     -----------------------------
  12. The 11th file bug was fixed in version 2.40 (without my knowledge it even
  13. existed!).  Version 2.41 is nothing but smoothing out the appearance of
  14. CD-Share on the local side.
  15.  
  16.                                 *NOTE*             
  17.                     -----------------------------
  18. Single file bug in versions 2.40 and 2.41 fixed.  Also, increased max file
  19. count to 1024 files.  Enjoy!
  20.  
  21.                              DESCRIPTION
  22.  
  23. CDS is a program that allows movement of a file from any drive to any 
  24. other temporary drive and subdirecory before download.  External 
  25. protocols such as DSZ are fully supported and all parameters are 
  26. passed on to the external protocol.  This is fully transparent to the 
  27. caller except a short delay while files are transferred.  The program 
  28. is designed for full use of CD-ROM minichanger devices on a multinode 
  29. BBS's without the use of doors.  It can be used in any BBS environment 
  30. that allows use of external file protocols.  It has been tested with 
  31. PCBoard version 14.5a, 386 and 486 computers, DSZ, and Lantastic NOS 
  32. 4.00.  
  33.  
  34. In addition, this program can be used on any networked BBS to 
  35. significantly decrease LAN traffic during file transfers.  Usually a 
  36. file is sent across the LAN to the local node then out over the modem 
  37. as it is downloaded.  During the entire download, pieces of the file 
  38. are being sent across the LAN. With this program, there is a single 
  39. copy of a file to the local hard disk, then the file is sent from 
  40. the local disk.  LAN traffic for the duration of the download is 
  41. eliminated.  This may significantly increase the efficiency of your 
  42. BBS, especially if you run several busy nodes.
  43.  
  44.  
  45.                      "SUNDAY"  SHAREWARE CONCEPT
  46.  
  47. No, nothing religious here.  This version is fully functional and 
  48. works very quickly... 6 days a week.  On the 7th day, Sunday, there 
  49. is a delay for 5 seconds with each transfer to the hard disk.  Lest 
  50. the caller think there is something wrong, it also puts out a short 
  51. note to the caller telling him about the delay for unregistered 
  52. shareware.   Obviously, this is to encourage registration of the 
  53. software yet to allow full use of CDShare until it is registered.  
  54. With the registration, you'll get a key file that will allow you to 
  55. disable all messages to the caller if you choose.  The key allows 
  56. full use without delays every day of the week.  
  57.  
  58. You may upload and freely distribute this program as long as it is 
  59. unmodified and contains only CDS.EXE and CDS.DOC.  You may not modify 
  60. this DOC file or program code.  You may recompress this file in any 
  61. format but you may not add advertising files to it with the exception 
  62. of a "ZIP header" or equivalent.  
  63.  
  64.  
  65.  
  66.                                  USE
  67.  
  68. This software is not free.  The user may use this program for 
  69. evaluation for a period of 30 days, after which he is expected to 
  70. register the program ($22.50) or discontinue use.  Use for more than 
  71. 30 days without registration represents a violation of copyright. 
  72. Please mail checks to: 
  73.     PSI, Attn: Nathan Hartwell
  74.     212 Shoreline Drive
  75.     Lakesite, TN 37379
  76.  
  77.  
  78.                               DISCLAIMER
  79.  
  80. This program is provided "as is" without warranty of any kind, either 
  81. expressed or implied including but not limited to the implied 
  82. warranties of merchantability and/or fitness for a particular 
  83. purpose.  (Sounds familiar, doesn't it?)  There is no warranty beyond 
  84. refund of any money paid to the author by the user.  In no event 
  85. shall the author, supporting BBS systems, Sysops, or PSI software be 
  86. held liable for any damage or losses resulting from the use of this 
  87. program.  It is up to the user to determine the correct usage of this 
  88. program on his system and he/she bears full responsibility for 
  89. correct implementation of it.  
  90.  
  91.  
  92.                             DOCUMENTATION
  93.  
  94. Now for a quick and simple doc file. 
  95.  
  96. Installation:
  97.  
  98. In each of your external protocol send batch files, add CDS.EXE 
  99. before your external protocol driver. 
  100.  
  101.     Example:  DSZ port %P speed %B estimate 0 sz -m %F
  102.                                  |
  103.                                  v
  104.               CDS DSZ port %P speed %B estimate 0 sz -m %F
  105.  
  106. Execution:
  107.  
  108.   CDS <Protocol Program Name> <Required Argument> [Other Optional Args.]
  109.  
  110.     Required Argument:  If no options are used, this will should be either
  111.                       the filename of the file to send or if the first
  112.                       character is an at sign (@), the control file (list
  113.                       of files to send).  Preferrably, all filenames have
  114.                       full path specs.
  115.  
  116.     Optional Args.:  You can pass all the arguments you would normally use,
  117.                    just make sure the above mentioned required argument is
  118.                    the last argument passed.
  119.  
  120.  
  121. Configuration File:
  122.  
  123.   Filename:  CDS.CFG
  124.   Location:  Either in current directory or directory from which CDS.EXE was
  125.            executed.
  126.  
  127.  
  128. Config file format.  The following is a list of valid commands and their
  129. required arguments:
  130.  
  131.   LogPath   - Full pathname for the logfile.
  132.   LogLevel  - A number from 1 to 6, where 1 puts the least amout in the log
  133.               and 6 puts everything in.
  134.   Temp      - Directory to use as temp storage.  Trailing backslash (\) is
  135.               optional.  You may use a RAM-Disk for this directory.
  136.   Drives    - The drive letter(s) of the drive(s) you want CD-Share to
  137.               consider removable media and hence copy files off of.
  138.   Port      - The COM Port Number (1 - 4)  Use if your COM Port uses standard
  139.               port addressing.  See list below.
  140.   XPort     - The hexadecimal address of the base port address your COM Port
  141.               is set to.  Example: COM1 is nomrally located at 3F8.
  142.   Msg       - Used to customize message sent to users.
  143.   Exec      - Command-line to execute on each file that is copied to the temp
  144.               directory.  Use '%s' in place of the filename to process.
  145.  
  146. Commands LogPath, Port, XPort, and Msg are required for non-registered
  147. copies.  If you are registered, leaving out the LogPath command disables
  148. logfile output, while leaving out either Port or XPort disbales the message
  149. output.
  150.  
  151. The order of these in the config file is not important, so long as they are
  152. each on their own line.
  153.  
  154.  
  155. Example config:
  156.  
  157. LogPath C:\BBS\CDS.LOG
  158. LogLevel 3
  159. Temp X:\
  160. Drives ABJKLM
  161. XPort 3F8
  162. Msg Are files all you get?
  163. Exec PKZip.Exe -z %s MySys.Txt
  164.  
  165. In this example, drives A:, B:, J:, K:, L:, and M: will have files copied
  166. from them to the temp directory, all others will be skipped.
  167.  
  168. NOTE: Do NOT separate the config commands and their parameters with tab
  169.       characters.  You may put multiple spaces in to make the config file
  170.       pretty, but the tab character will only be removed (and not
  171.       translated).
  172.  
  173. Standard COM Port base addresses: (for COM1 - COM4)
  174.  
  175.   COM1: 3F8
  176.   COM2: 2F8
  177.   COM3: 3E8
  178.   COM4: 2E8
  179.  
  180.  
  181. DOS Critical error trapping has been added.  CD-Share will retry up 
  182. to five (5) times before terminating.  No log entries are generated 
  183. for critical errors.
  184.  
  185.  
  186. Notes:
  187.  
  188.  *  - Files are copied from media devices to the specified path.
  189.       This may be a RAM-Disk.  The files copied are then deleted
  190.       afterwards, so if you are running multi-node make a .CFG for
  191.       each node.
  192.  
  193.  *  - For use with multinode BBS systems, and minichangers you should 
  194.       disable all internal protocols.  With PCBoard, you'd edit the 
  195.       PCBPROT.DAT, see your manual. 
  196.  
  197.  *  - You may want to put a TEMPFILE subdirectory on each local disk 
  198.       to decrease network traffic.  The file(s) will be copied from the
  199.       remote device to the local TEMPFILE subdirectory once and deleted.  
  200.  
  201.  
  202. PLUGS:
  203.   Software alpha tested on Rose and Crown BBS (615) 892-0097 
  204.   (>5GB, over 60,000 files, USR/DS, 1st call downloads).  Current 
  205.   version available.  Contact author, Nathan Hartwell, on this BBS, or 
  206.   RIME CD-ROM echo. 
  207.   
  208.   PSI Software:  Custom programming available.
  209.  
  210. Support BBS:
  211.   The Genetics Lab
  212.   SysOp: Tiberious Velnoq (aka Nathan Hartwell)
  213.   (615) 842-0852 - 24 hr/day - 12/2400 Baud
  214.   FidoNet 1:362/116.0 - PSI-Net 91:615/101.0
  215.   Latest version can be downloaded/file requested from this system.
  216.   Compuserve: 71451,300 - Internet: 71451.300@compuserve.com
  217.   
  218. -------------------------------------------------------------
  219. Further notes on PCBoard installation, (David Ellison, Sysop,
  220. Rose and Crown BBS) 
  221. RIME ->RCROWN     
  222. -------------------------------------------------------------
  223.  
  224. PCBoard SAMPLE BATCH FILES:
  225.   These are for COM2.  Change "port 2" to "port 1" for COM1
  226.  
  227. Zmodem send with DSZ:  PCBSZ.BAT   
  228.    echo off
  229.    if exist cds.log del cds.log
  230.    if exist pcberr.fil del pcberr.fil
  231.    if exist pcbdsz.log del pcbdsz.log
  232.    cds dsz.com handshake both port 2 pB4096 z sz %3
  233.  
  234. Zmodem receive with DSZ:  PCBRZ.BAT
  235.    echo off
  236.    if exist pcberr.fil del pcberr.fil
  237.    if exist pcbdsz.log del pcbdsz.log
  238.    dsz.com handshake both port 2 pB4096 z pr1 rz -p %3
  239.  
  240. Xmodem send with DSZ:   PCBSX.BAT 
  241.   echo off
  242.   if exist cds.log del cds.log
  243.   if exist pcberr.fil del pcberr.fil
  244.   if exist pcbdsz.log del pcbdsz.log
  245.   cds dsz.com handshake both port 2 pB4096 sx %3
  246.  
  247. Xmodem receive with DSZ:  PCBRX.BAT
  248.   echo off
  249.   if exist pcberr.fil del pcberr.fil
  250.   if exist pcbdsz.log del pcbdsz.log
  251.   dsz ha both port 2 pB4096 rx %3
  252.  
  253. Note: Be sure to change PCBPROT.DAT types (PCBSETUP, FILE LOCATIONS 
  254.   2).  "I" reflects internal, "D" is for DSZ.LOG (use for Zmodem 
  255.   protocol), "S" is for shelled protocols (use for Xmodem).  You 
  256.   shouldn't have any internal protocols left when you finish unless 
  257.   that particular node doesn't have access to the CD-ROM minichanger.  
  258.  
  259.   All protocols must be external, either shelled or DSZ.LOG 
  260.   supporting.  Use of the wrong type (D instead of S for example with 
  261.   Xmodem) can result in the filename not being passed to DSZ.  This 
  262.   will cause you a bit of lost time (like a weekend).  
  263.   
  264.   DSZ is exquisitely case sensitive, change the case in any of the 
  265.   above "dsz" lines and you'll have file transfer difficulties.  The 
  266.   above files do work on the Rose and Crown with Dual Standard 
  267.   modems, 16550 UARTS, and registered DSZ.  
  268.  
  269.   If you have questions about what is being 
  270.   passed to DSZ from PCBoard, put the following line in just above 
  271.   the dsz line in the batch file: 
  272.   echo %1 %2 %3 %4 %5 
  273.   You'll see exactly what's being passed on to DSZ by the BBS. 
  274.  
  275. With 1 or 2 Pioneer minichangers you can have 3.9 Gigabytes with a 6 disk 
  276. changer or 7.8 Gigabytes with 2 stacked changers.  For us, it is 
  277. definitely worth the trouble to set up.  Minichanger has been trouble 
  278. free since installation.
  279.  
  280.  
  281.